home *** CD-ROM | disk | FTP | other *** search
/ Express Pd: GALORE / Express Pd Galore - The Amiga PD & Shareware CD (1994)(Express Pd)[!][Amiga-CD32-CDTV].iso / productivity / code_mungus / manual < prev    next >
Text File  |  1978-01-06  |  15KB  |  453 lines
  1.                             -------------
  2.  
  3.                              Code Mungus
  4.  
  5.                             -------------
  6.  
  7.  
  8.  
  9.                                 * By *
  10.  
  11.  
  12.  
  13.                             Nicholas Smith
  14.  
  15.  
  16.  
  17.                              ©August 1993
  18.  
  19.  
  20.  
  21.  
  22.  
  23.          Latest Version: 5.7     Last Update: 23 August 1993
  24.  
  25.  
  26. Written in GFA Basic v3.5
  27.  
  28.  
  29. What Is Code Mungus?
  30. ~~~~~~~~~~~~~~~~~~~~
  31.  
  32.   Code Mungus is an aid to learner drivers (as if you hadn't of
  33. guessed). Its purpose is to ask the user various questions about the
  34. Highway Code. It effectively replaces the task of the learner's
  35. relatives or friends. But of what use is it? Although it is true that
  36. the section of the driving test where the examiner asks a pupil
  37. questions on the Highway Code has declined in importance over the last
  38. few decades, it is still a necessity. The use of this is to let the
  39. examiner know how well a pupil understands factors such as road safety
  40. and vehicular law.
  41.  
  42.   I do not believe that a pupil can fail by not answering all the
  43. questions correctly. One person I know was asked twenty questions and
  44. only correctly answered one of them, and he still passed. This goes to
  45. prove that the chance of you passing is influenced by the examiner.
  46. One simple way to increase this chance is to actually learn the
  47. Highway Code.
  48.  
  49.   When I began to learn to drive I realised that this is not as
  50. easy as one would first imagine. It is relatively feasible to learn
  51. the information but it is near impossible to get someone to test your
  52. knowledge of it. You ask friends or relatives but you find that
  53. they are doing something much more important (like cleaning the
  54. toilet).
  55.  
  56.   It was this reaction that led me to the conclusion that it must be
  57. very tiresome to test someone on the Highway Code. It is fine to test
  58. others before you pass the test but as soon as you have, you do
  59. not want to bother yourself with it. I therefore came up with Code
  60. Mungus.
  61.  
  62.   Code Mungus can be used as a general test to see how familiar
  63. you are with the Highway Code or it can be used to see in which areas
  64. you need to carry out more revision in. There  are two types of
  65. question that can be asked:
  66.  
  67.   The first are text based. These are on on topics such as
  68. stopping distances, motorway use, fog conditions, moving off and
  69. overtaking. Basically it covers the all the rules of the Highway
  70. Code (numbers 1 to 198). Overall there are 123 text questions.
  71.  
  72.   The second type are graphic questions. These are traffic signs
  73. that a driver may find on or by the road. I believe that the
  74. selection available (73) covers virtually all types (the designs were
  75. obtained from the Highway Code booklet pages 53 to 57).
  76.  
  77.   There are no questions on the general rules of the Highway Code or
  78. for other types of transport (e.g. cyclists, horse riders). Code
  79. Mungus only asks questions that a motorist needs to know. All the
  80. questions are always specific to the Highway Code booklet (although I
  81. did make some up). In other words, a question may have two possible
  82. correct answers but the program will only accept the one that is
  83. commented upon in the Highway Code.
  84.  
  85. What Do I Need To Use Code Mungus?
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87.  
  88.   Code Mungus will, to my knowledge, run on any Amiga. I have
  89. beta tested it on an Amiga 500, an Amiga 500 with a half megabyte
  90. expansion and an Amiga Plus. It worked fine on all of these.
  91.  
  92.   The important files that you should have on this disk are;
  93.  
  94.  Root Directory:
  95.  
  96.   Code_Mungus
  97.   Code_Mungus.info
  98.   Code_Mungus.config
  99.   High_Scores.LST
  100.   Palette
  101.   Config
  102.   Manual
  103.   Manual.info
  104.  
  105.  Signs\
  106.  
  107.   s1
  108.   .
  109.   .
  110.   .
  111.   s73
  112.  
  113.   All these files are required in  order to make the program work
  114. correctly. It  is  possible  to  use  it  without the High_Scores.LST
  115. and Setup files (I have included a routine to set the system variables
  116. and the high score table to preset levels if they are missing) but I
  117. would suggest that you retrieve them as soon as possible. There is a
  118. check included in Code Mungus to imprint preset sets of data of high
  119. scores on to the disk in case the High_Score.LST has been deleted. To
  120. implement this process, begin the quiz and continue with it until you
  121. are returned to the menu. The Setup file can be re-created from the
  122. Setup screen. Details of this are included
  123. in the menu section.
  124.  
  125. How To Load Code Mungus: For the computer illiterate
  126. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  127.  
  128.   Code Mungus disk is bootable and this can be done by simply
  129. inserting the disk into any drive. After a few seconds the intro will
  130. appear and you will be asked whether you have lots of memory (over
  131. 1meg). If you have type y and then press return. The startup-sequence
  132. will then copy all the files in the signs directory to ram disk (this
  133. speeds up the execution of the program). This process will take some
  134. time. If you only have ½ a meg then you will have to type n.
  135.  
  136. Workbench will then appear. Double click on the disk icon and then
  137. double click on the Code_Mungus icon. After a short period a menu will
  138. be displayed.
  139.  
  140. Menu Options
  141. ~~~~~~~~~~~~
  142.  
  143.   Each option can be selected by depressing the left mouse button
  144. over the required box.
  145.  
  146. START:
  147.  
  148.   When you select this option the menu disappears and a white screen
  149. is displayed in its place. A text question will then be printed in
  150. along with three possible answers. In order to answer this question
  151. you must press the button (displayed at the bottom of the screen) that
  152. corresponds to the answer which you  believe is correct. Providing
  153. that you have the extras facility on (more on this later), you will be
  154. told whether you were correct or not.
  155.  
  156.   If you were not then the right answer is pointed out. After
  157. all the required text questions have been asked (this can be changed
  158. by the Config option), the screen will turn black and after a small
  159. period of disk access (providing the signs are not already loaded into
  160. the ram disk) a sign will be displayed in the middle of it. You must
  161. then select an answer button. The result of your input will then be
  162. shown.
  163.  
  164.    When all the graphic questions have been asked the black screen
  165. will close. The results of the last turn will then be analysed. Your
  166. score will be displayed along with my personal evaluation. Should your
  167. score be high enough to get into the high score table you will then be
  168. asked to type in your name. This will then be saved to disk along with
  169. your score (as a percentage) and the date. You can use this feature to
  170. plot your progress over a number of turns. The high score table will
  171. then be displayed. If your score was not high enough then only the
  172. table is shown.
  173.  
  174.   If you find the table quickly becomes filled with 100%'s, you can
  175. delete the High_Scores.lst file from the disk through Workbench or the
  176. CLI. The next time the program in executed, preset data for the table
  177. will be saved to disk. This will effectively clear the table. This
  178. process will also so work if you lose the High_Scores.lst.
  179.  
  180. ABOUT:
  181.  
  182.   This gives general information about Code Mungus and its author.
  183.  
  184. HELP:
  185.  
  186.   When you select this option you will be given the message that the
  187. help facility is on. This means that whenever you select an option
  188. from the menu you will be shown the option's associated help file. To
  189. return the options to normal click on the help button again.
  190.  
  191.   You can tell the current status of the help button (either On or
  192. OFF)
  193. by seeing it the button looks as though it is de-pressed (but not
  194. suicidal).
  195.  
  196. SCORES:
  197.  
  198.    This displays the high score table.
  199.  
  200. CONFIG:
  201.  
  202.    This option allows you to control Code Mungus (by changing the
  203. environmental variables). It is effectively like the Preferences
  204. program(s) that allows you  to alter the  Workbench. It makes it
  205. possible to change the inward workings  of the program to your own
  206. personal tastes. Once selected a  menu appears into which the current
  207. status of the program is displayed. You can choose the settings of the
  208. features shown in buttons by clicking the left mouse button on the
  209. response box (this will show either On or OFF). To change the number
  210. of questions asked you will need to click upon the response box. This
  211. will then clear and allow you to type a number. For example if you
  212. typed in 34 in the text question box you would be asked
  213. 34 text questions. To enter a single digit (1,2,4 etc) press zero and
  214. then the number you require. You cannot select zero on its own or
  215. numbers above the maximum (this constraint is detailed below).
  216.  
  217.   The facilities available are;
  218.  
  219. * Speech
  220.  
  221.        Do you want the crap phonetic speech? If this option is
  222.        switched ON then a computer has the ability to
  223.        announce what it is doing. Unfortunately this tends
  224.        to slow Code Mungus down.
  225.  
  226.        N.B. In order for this to work you MUST have the
  227.        files translator.library in the libs directory and
  228.        narrator.device in the devs directory.
  229.  
  230. * Answers
  231.  
  232.        Do you want to be told if your answer is correct or
  233.        not?. If it is ON then the user can identify the
  234.        areas where he or she needs to do more revision in.
  235.        If it is OFF then the question and answer section
  236.        speeds up considerably (1.5 seconds per question).
  237.  
  238. * No. of text questions
  239.  
  240.        How many test questions do you want to be asked?
  241.        The minimum is 1, the maximum is 50.
  242.  
  243. * No. of graphic questions
  244.  
  245.        Similar to the above facility. The Minimum is 1,
  246.        the maximum is 35.
  247.  
  248. * Save high scores
  249.  
  250.        If you get a score that is high enough to get into the
  251.        high score table, do you want it to be saved to disk?
  252.  
  253. * Save
  254.  
  255.        This will save the new values of the environmental
  256.        variables to disk.
  257.  
  258. * Use
  259.  
  260.        This will set the variables to the levels you specified
  261.        but will not save them to disk.
  262.  
  263. * Cancel
  264.  
  265.        This will prevent any new changes from effecting the
  266.        program. The variables will be restored to their
  267.        original settings.
  268.  
  269. QUIT:
  270.  
  271.   This option allows you to exit Code Mungus. To exit select YES when
  272. the alert box appears. If NO is selected then you are returned to the
  273. menu. You can also quit whilst using Code Mungus by pressing CTRL-
  274. SHIFT-ALT.
  275.  
  276. Problem Diagnosis
  277. ~~~~~~~~~~~~~~~~~
  278.  
  279. PROBLEM: Corrupt files
  280.  
  281.   Do not exit from Code Mungus (by either pressing CTRL-SHIFT-ALT or
  282. by implementing a soft reset) whilst Code Mungus is using the disk
  283. drive. If you should do this then there is a risk that a file is being
  284. saved to file. Exiting will cause the disk activity to stop
  285. prematurely and thus will corrupt the file. Next time Code Mungus is
  286. run it will find that there is not enough data in the specific file
  287. and this will cause a fatal error.
  288.  
  289. SOLUTION
  290.  
  291.   Delete the corrupt file from the disk and establish a new one
  292. (by using the process described in the menu options section).
  293.  
  294. PROBLEM: Loss of control
  295.  
  296.   When you are using Code Mungus you suddenly become unable to
  297. do anything.
  298.  
  299. SOLUTION
  300.  
  301. YOUR BUGGERED! (more than likely!!!)
  302.  
  303. Try to click the mouse on the screen to try and regain control. If
  304. this fails you will have to re-boot (if you can be bothered).
  305.  
  306. Disclaimer
  307. ~~~~~~~~~~
  308.  
  309.   I cannot guarantee (waffle, waffle) that Code Mungus will work on
  310. any machine. By using this program you are taking full responsibility
  311. for any faults (waffle, waffle) or problems that the program may
  312. cause. You cannot sue or claim (waffle, waffle) against the author in
  313. any way. You also cannot sue me it you fail your driving test due my
  314. questions having the wrong answers!
  315.  
  316.   The program itself is in the public domain and can thus be
  317. distributed to anyone, providing that all the files on the disk are
  318. kept (including the Manual) intact and that you do not change any of
  319. the code. I allow it to be distributed on any collection disks
  320. (including Fred Fish). Bugger knows why anyone should want to!
  321.  
  322. Conclusion
  323. ~~~~~~~~~~
  324.  
  325.   I hope that you find this program of some use to you. After having
  326. to type in all the data statements and beta testing them I have become
  327. an expert in the Highway Code. This put me in good stead for my
  328. driving test which I happened to pass first time!
  329.  
  330.  
  331.       ABC see yer, Wouldn't want to be yer (as they say!)
  332.  
  333.  
  334.                            Nicholas Smith
  335.  
  336. Please send me some money (£) if you find this program useful.
  337. Alternatively you could send me a disk packed with smart utilities.
  338. Hey, I'm not fussy.
  339.  
  340.  
  341. You can contact me with any views on Code Mungus at:
  342.  
  343. The Old Thatch
  344. Main Street
  345. Tingewick
  346. Bucks
  347. MK18 4NN
  348.  
  349. By the way, this is the only Highway Code - type of program available,
  350. PD or commercial (even though there is a French CD Multi-Media
  351. demonstration along these lines). Remember where you saw it first!!!
  352.  
  353.  
  354. Thanks
  355. ~~~~~~
  356. I would like to thank;
  357.  
  358.  
  359.  
  360. Edger Grimsdale - A-Level computing teacher
  361.  
  362. J Findlay - geezer who compiled this prog
  363.  
  364.  
  365. THE HISTORY OF CODE MUNGUS
  366. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  367.  
  368. I began to wrote this program in June 1992 as an A-Level computer
  369. studies project. It was based on a similar piece of software on that
  370. now defunct rubber-keyed computer, the Spectrum. I think it was called
  371. the Highway Code and was published by Horizon. Anyway, between then
  372. and now it has gone through just a few changes (as you can see form
  373. the version number!). Here are just a few...
  374.  
  375.  
  376. v1.0 The original - If you find a copy take it to the Antiques Road
  377. Show
  378.  
  379. Wrote the text question routine. No front end (oh err!)
  380.  
  381. v1.1
  382.  
  383. Added the graphics using D-Paint III and the IFF-To-BOB program
  384. (supplied with GFA Basic). Managed to lose the files (I'm an expert at
  385. this).
  386.  
  387. v1.2
  388.  
  389. Re-did the graphics. Managed to get both bits working in harmony
  390. (eventually)
  391.  
  392. v2.0
  393.  
  394. Added the front end. "Borrowed" the menu form the IFF-To-BOB program.
  395. Two dimensional and basically crap. Still it saved me writing one (I'm
  396. like that).
  397.  
  398. v2.1
  399.  
  400. Created the help function. This original feature displayed six
  401. separate windows with documentation about the program. Took about two
  402. seconds to do this!
  403.  
  404. v2.2
  405.  
  406. Configure screen invented. Had to type in Y's, N's and numbers. Looked
  407. extremely tacky and Spectrumish.
  408.  
  409. v2.3
  410.  
  411. Tried the program on a 1.3 machine. All the colours where very ugly.
  412. Changed the palette.
  413.  
  414. v3.0
  415.  
  416. Quit feature added. Used system alert boxes. Looked bloody awful.
  417.  
  418. v3.1
  419.  
  420. Added phonetic speech. I now wonder why.
  421.  
  422. v3.2
  423.  
  424. High score table implemented. Lost the graphics files again (I told
  425. you I was an expert).
  426.  
  427. v4.0
  428.  
  429. Decided to change front end. Attempted to use G_Maskdesigner program.
  430. Far to complicated. "Borrowed" the colour scheme. Began to write all
  431. the windows and boxes routine for the menu. Now looked Workbench
  432. 2.0ish.
  433.  
  434. v4.1
  435.  
  436. Added new-look windows and boxes to all the other parts of the
  437. program.
  438.  
  439. v5.0 The polishing up phase
  440.  
  441. Ran the program through a spell checker (On Kindwords 2 - Aahhhhrr).
  442. There weren't many errors in the questions (honest).
  443.  
  444. v5.1
  445. .
  446. .      Can't remember
  447. .
  448. v5.6
  449.  
  450. v5.7 Les Finarley
  451.  
  452. Finished it at last. Now to just get it compiled....
  453.